In [1]:
%matplotlib inline
%config InlineBackend.figure_format = 'retina'

from matplotlib import pyplot as plt
from lifelines import CoxPHFitter
import numpy as np
import pandas as pd
from lifelines.datasets import load_rossi

plt.style.use('bmh')

Assessing Cox model fit using residuals (work in progress)

This tutorial is on some common use cases of the (many) residuals of the Cox model. We can use resdiuals to diagnose a model's poor fit to a dataset, and improve an existing model's fit.


In [2]:
df = load_rossi()

df['age_strata'] = pd.cut(df['age'], np.arange(0, 80, 5))
df = df.drop('age', axis=1)

cph = CoxPHFitter()
cph.fit(df, 'week', 'arrest', strata=['age_strata', 'wexp'])


Out[2]:
<lifelines.CoxPHFitter:"None", fitted with 432 total observations, 318 right-censored observations>

In [3]:
cph.print_summary()
cph.plot();


model lifelines.CoxPHFitter
duration col 'week'
event col 'arrest'
strata [age_strata, wexp]
number of observations 432
number of events observed 114
partial log-likelihood -434.50
time fit was run 2019-11-17 14:15:30 UTC
coef exp(coef) se(coef) coef lower 95% coef upper 95% exp(coef) lower 95% exp(coef) upper 95% z p -log2(p)
fin -0.41 0.67 0.19 -0.79 -0.03 0.46 0.97 -2.10 0.04 4.82
race 0.29 1.33 0.31 -0.32 0.90 0.73 2.45 0.93 0.35 1.50
mar -0.34 0.71 0.39 -1.10 0.42 0.33 1.52 -0.87 0.38 1.38
paro -0.10 0.91 0.20 -0.48 0.29 0.62 1.33 -0.50 0.62 0.70
prio 0.08 1.08 0.03 0.02 0.14 1.03 1.15 2.83 <0.005 7.73

Martingale residuals

Defined as:

$$ \delta_i - \Lambda(T_i) \\ = \delta_i - \beta_0(T_i)\exp(\beta^T x_i)$$

where $T_i$ is the total observation time of subject $i$ and $\delta_i$ denotes whether they died under observation of not (event_observed in lifelines).

From [1]:

Martingale residuals take a value between $[1,−\inf]$ for uncensored observations and $[0,−\inf]$ for censored observations. Martingale residuals can be used to assess the true functional form of a particular covariate (Thernau et al. (1990)). It is often useful to overlay a LOESS curve over this plot as they can be noisy in plots with lots of observations. Martingale residuals can also be used to assess outliers in the data set whereby the survivor function predicts an event either too early or too late, however, it's often better to use the deviance residual for this.

From [2]:

Positive values mean that the patient died sooner than expected (according to the model); negative values mean that the patient lived longer than expected (or were censored).


In [4]:
r = cph.compute_residuals(df, 'martingale')
r.head()


Out[4]:
week arrest martingale
313 1.0 True 0.989383
79 5.0 True 0.972812
60 6.0 True 0.947727
225 7.0 True 0.976976
138 8.0 True 0.920273

In [5]:
r.plot.scatter(
    x='week', y='martingale', c=np.where(r['arrest'], '#008fd5', '#fc4f30'),
    alpha=0.75
)


Out[5]:
<matplotlib.axes._subplots.AxesSubplot at 0x11b722dd8>

Deviance residuals

One problem with martingale residuals is that they are not symetric around 0. Deviance residuals are a transform of martingale residuals them symetric.

  • Roughly symmetric around zero, with approximate standard deviation equal to 1.
  • Positive values mean that the patient died sooner than expected.
  • Negative values mean that the patient lived longer than expected (or were censored).
  • Very large or small values are likely outliers.

In [6]:
r = cph.compute_residuals(df, 'deviance')
r.head()


Out[6]:
week arrest deviance
313 1.0 True 2.666807
79 5.0 True 2.294411
60 6.0 True 2.001769
225 7.0 True 2.363998
138 8.0 True 1.793808

In [7]:
r.plot.scatter(
    x='week', y='deviance', c=np.where(r['arrest'], '#008fd5', '#fc4f30'),
    alpha=0.75
)


Out[7]:
<matplotlib.axes._subplots.AxesSubplot at 0x1046478d0>

In [8]:
r = r.join(df.drop(['week', 'arrest'], axis=1))

In [9]:
plt.scatter(r['prio'], r['deviance'], color=np.where(r['arrest'], '#008fd5', '#fc4f30'))


Out[9]:
<matplotlib.collections.PathCollection at 0x11ec82208>

In [ ]:


In [10]:
r = cph.compute_residuals(df, 'delta_beta')
r.head()
r = r.join(df[['week', 'arrest']])
r.head()


Out[10]:
fin race mar paro prio week arrest
313 -0.005650 -0.011593 0.012142 -0.027450 -0.020486 1 1
79 -0.005761 -0.005810 0.007687 -0.020926 -0.013372 5 1
60 -0.005783 -0.000146 0.003277 -0.014325 -0.006315 6 1
225 0.014998 -0.041568 0.004855 -0.002254 -0.015725 7 1
138 0.011572 0.005331 -0.004241 0.013036 0.004405 8 1

In [11]:
plt.scatter(r['week'], r['prio'], color=np.where(r['arrest'], '#008fd5', '#fc4f30'))


Out[11]:
<matplotlib.collections.PathCollection at 0x11f016748>

In [ ]: